.. _cmsGnGetAxisMap:

cmsGnGetAxisMap
==========================
--------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmsGnGetAxisMap ([in] VT_I4 BoardId, [out] VT_PI4 AxisMapMask )



DESCRIPTION
`````````````  

- 연결된 서보의 id 를 반환합니다. 이 함수를 통해 현재 마스터 보드에 연결된 서보의 id 를 알 수 있습니다.

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cms 가 붙지 않습니다.

PARAMETER
`````````````

▶ BoardId: 사용자가 설정한 디바이스(보드) ID.

▶ AxisMapMask: 연결된 서보 id 를 마스크 값(32 비트, BIT0 ~ BIT31)을 반환합니다. 이 값의
BI1T0~BIT31 을 이용하여 현재 연결된 축을 확인할 수 있습니다.. 각 비트의 값이 0 이면 해당
축(비트의 순서와 일치하는 축)은 연결되지 않은 것이며 1 이면 해당 축이 연결된 것입니다.

  .. csv-table::
    :widths: 10 90
    :header-rows: 1
    :stub-columns: 0

    Bit Number, Meaning
    BIT0, 0번 축의 연결여부: 0 => 연결안됨 / 1 => 연결됨
    BIT1, 1번 축의 연결여부: 0 => 연결안됨 / 1 => 연결됨
    BIT2, 2번 축의 연결여부: 0 => 연결안됨 / 1 => 연결됨
    BIT3, 3번 축의 연결여부: 0 => 연결안됨 / 1 => 연결됨
    BIT4, 4번 축의 연결여부: 0 => 연결안됨 / 1 => 연결됨
    BIT5, 5번 축의 연결여부: 0 => 연결안됨 / 1 => 연결됨
    BIT6, 6번 축의 연결여부: 0 => 연결안됨 / 1 => 연결됨
    BIT7, 8번 축의 연결여부: 0 => 연결안됨 / 1 => 연결됨
    


RETURN VALUE
`````````````

+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+

EXAMPLE
```````````
.. code-block:: c++
 :linenos:
 :emphasize-lines: 4

 C/C++ 
 #define DEV0 0
 #include “ComiSSCNET3_SDK.h”
 #include “ComiSSCNET3_SDK_Def.h”

 // 연결된 서보 정보를 반환합니다.
 cmsGnGetAxisMap ( DEV0, &AxisMapMask );